\chapter{Uživatelská příručka}

\section{Navigace po aplikaci}
Ústředním bodem zůstává jedno aktivní okno. Obsah okna se mění dle navigace, buďto pomocí navigačního menu nebo pomocí tlačítek na dílčích stránkách. Navigační menu obsahuje tyto položky:

\begin{itemize}
	\item Home
	\item Existing Projects
	\item Existing Solutions
	\item Název aktivního solutionu
\end{itemize}

\newpage{}

\section{Home}
Po startu aplikace se objeví domovská stránka (viz obr. \ref{fig:homepage}), která slouží jako rozcestník. Tato stránka obsahuje 4 tlačítka. Obrázek na pozadí tlačítek byl zvolen tak, že více domů má přestavovat \textbf{Solution} a jeden dům \textbf{Projekt}. Ikonka kříže či plusu, která se nachází v levém rohu tlačítka reprezentuje tvorbu něčeho nového a ikonka oka má vyjadřovat slovo ,,přehled''.

\begin{itemize}
	\item New Solution
	\item Existing Solutions
	\item New Project
	\item Existing Projects
\end{itemize}

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/homepage}
\end{center}
\caption{Domovská stránka}
\label{fig:homepage}
\end{figure}

\newpage{}

\section{New Solution}
Stránka \textit{New Solution} (viz obr. \ref{fig:newsolution}) slouží jak jako zakládací, tak jako editační formulář pro entitu \textit{Solution}. Tento formulář obsahuje pouze jednu položku a to název. Tato položka je povinná, pokud není vyplněná, tak nelze stisknout tlačítko ,,Save solution''. Editace je rozpoznána neprázdným parametrem při navigaci, konkrétně předáním instance \textit{Solution}, kterou chceme editovat. Po stisku tlačítka ,,Save solution'' budeme přesměrováni na \textit{Detail solutionu}.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/newsolution}
\end{center}
\caption{Zakládací stránka Solutionu}
\label{fig:newsolution}
\end{figure}

\newpage{}

\section{Existing Solutions}
\textit{Existing Solutions} (viz obr. \ref{fig:existingsolutions}) je přehledová stránka zobrazující všechny exitující \textit{solutiony}. Tato stránka také umožňuje jednotlivá řešení mazat či aktivovat. Po aktivaci dojde k přesměrování na detailovou stránku označeného \textit{solutionu}.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/existingsolutions}
\end{center}
\caption{Přehledová stránka všech Solutionů}
\label{fig:existingsolutions}
\end{figure}

\newpage{}

\section{New Project}
Stránka \textit{New Project} (viz obr. \ref{fig:newproject}) slouží jako zakládací, i editační formulář pro entitu \textit{Project}. Tento formulář obsahuje dvě položky, název a počet podlaží. Obě položky jsou povinné, pokud nejsou vyplněné, tak nelze uložit daný \textit{Project}. Editace je rozpoznána neprázdným parametrem při navigaci, konkrétně předáním instance \textit{Project}, kterou chceme editovat. Po stisku tlačítka ,,Save project'' dojde k přesměrování na \textit{detail projektu}.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/newproject}
\end{center}
\caption{Zakládací stránka Projektu}
\label{fig:newproject}
\end{figure}

\newpage{}

\section{Existing Project}
\textit{Existing Project} (viz obr. \ref{fig:existingprojects}) je přehledová stránka zobrazující všechny exitující \textit{Projekty}. Dále umožňuje mazat či aktivovat daný \textit{Project}. Po aktivaci dojde k přesměrování na detailovou stránku označeného \textit{projektu}.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/existingprojects}
\end{center}
\caption{Přehledová stránka všech Projektů}
\label{fig:existingprojects}
\end{figure}

\newpage{}

\section{Project detail}
Stránka \textit{Project detail} (viz obr. \ref{fig:projectdetail}) zobrazuje především náhled na panelový dům ve 3D. Po pravé straně je seznam akcí, které lze provádět nad daným projektem. První akce je \textbf{Rename project}, která zobrazí editační stránku \textit{New Project}. Následuje akce \textit{Draw base}, která slouží ke kreslení půdorysu domu. Poslední akcí je \textit{Draw on panels}, která umožňuje přidávat jednotlivé typy panelů na stěny a samotné kreslení na zdi. 

3D model se zobrazí, až po splnění těchto kritérií. Bude vytvořen nákres půdorysu a bude vygenerována alespoň základní (holá) stěna panelového domu. 
S trojrozměrnou projekcí lze manipulovat pomocí myši. Při podržení pravého tlačítka dochází k rotaci podle vyznačeného středového znaku. Stiskem kolečka myši lze objekty manipulovat a točením lze objekt přiblížit či oddálit.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/projectdetail}
\end{center}
\caption{Detail projektu}
\label{fig:projectdetail}
\end{figure}

\newpage{}

\section{Draw base}

Stránka \textit{Base detail} (viz obr. \ref{fig:projectdetail}) usnadňuje uživateli návrh půdorysu panelového domu. Tento půdorys může být libovolný polygon, ale musí splňovat podmínku, že se jednotlivé stěny nebudou křížit a dále podmínku uzavřenosti.

Samotnou kresbu polygonu zahájíme stiskem levého tlačítka myši a následující rohy domu vkládáme stejným gestem. Aplikace sama hlídá křížení stěn a uživatele na tuto skutečnost upozorňuje pomocí změny barvy právě tažené stěny a jejího stylu na čáru přerušovanou. Dále je také pozorovatelná změna kurzoru myši. Ukončení celého polygonu je docíleno pomocí stisku pravého tlačítka myši.

Nevhodně navržený polygon lze smazat pomocí tlačítka \textit{Clear}, vrátit se na detail projektu bez provedení změn lze tlačítkem \textit{Back} a pro uložení slouží tlačítko \textit{Save}.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/base}
\end{center}
\caption{Návrh půdorysu panelového domu}
\label{fig:base}
\end{figure}

\newpage{}

\section{Draw on panels}
Po doplnění půdorysu budovy se na \textit{detailu projektu} aktivuje tlačítko \textbf{Draw on panels}. Po jeho stisku budeme přesměrováni na stránku \textit{Draw on panels}. V horní části se nachází dva panely, \textbf{Base} a \textbf{Painting}. Střední část reprezentuje obvodové zdivo budovy a ve spodní části se nachází tlačítka pro \textbf{Import}, \textbf{Export} či \textbf{Reset}.

\subsection{Umisťování bloků}
První panel (Base) slouží pro manipulaci s panely (viz obr. \ref{fig:paneldrawer1}). Výběrem konkrétního panelu a přejetí kurzorem myši na stěny panelového domu lze tyto prvky rozmístit. Panel nesmí přesahovat hrany domu a nesmí se vzájemně překrývat. Aplikace na tuto skutečnost upozorňuje pomocí změny kurzoru myši a neumožňuje špatné rozmístění. Po umístění na správnou pozici je následně vybraný panel rozkopírován na všechna nižší patra budovy. 

Jedinou výjimkou je panel označený jako ,,BlockDoorA'', který nelze umisťovat libovolně, ale musí být součástí stejně velkého panelu, ať už okna či balkónu. Po najetí na tyto typy panelů se kurzor myší změní na ruku a lze levým tlačítkem myši zaměnit poslední panel za dveře. 

První tlačítko \textbf{Remove} jako jediné není panelem, ale slouží k odstraňování nevhodně umístěných panelů. Po najetí na panel se změní kurzor myši na kříž a kliknutím levého tlačítka myši lze celou skupinu odmazat.

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/paneldrawer1}
\end{center}
\caption{Umisťování bloků}
\label{fig:paneldrawer1}
\end{figure}

\newpage{}

\subsection{Kresba na zeď}
Druhý panel (Painting) je určen pro triviální kresby (viz obr. \ref{fig:paneldrawer1}). Vedle tlačítek se základními elementy oválu a obdelníku se nachází dva výklopníky s možností výběru barvy. První z nich \textbf{Brush} definuje obrys obrazce a druhý \textbf{Fill} jeho výplň. Po stisku tlačítka lze pomocí stisku levého tlačítka a tažením definovat rozměr obrazce. Po puštění se obrazec uloží. 

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/paneldrawer2}
\end{center}
\caption{Kreslení na stěny}
\label{fig:paneldrawer2}
\end{figure}

Pro větší komfort lze použít akční tlačítko \textbf{Export layer}, čímž se na vybraném uložišti objeví 3 obrázky ve formátu PNG. Tento formát podporuje transparentní barvy, takže lze nyní v programu třetí strany simulovat rozmístění bloků jako v aplikaci \textbf{Panel Composer}. Jedním z grafických programů, který je zdarma je \textbf{Paint.NET} (\cite{paintnet}). Otevřeme si pro editaci vrstvu s číselným označením ,,00'' a postupně přidáváme pomocí tažením myši zbývající vrstvy tak, jak jde číselná řada za sebou. Jakmile máme všechny vrstvy v \textbf{Paint.NET} aplikaci, tak opětovně aktivujeme nultou vrstvu a můžeme kreslit (viz obr. \ref{fig:paintnet}).

\newpage{}

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/paintnet}
\end{center}
\caption{Kreslení v Paint.net}
\label{fig:paintnet}
\end{figure}

Nultá vrstva se nachází za jednoduchými obrazci z aplikace \textbf{Panel Composer} a za panely samotnými. Tyto vrstvy jsou exportovány pro snazší přehled při kreslení a není je potřeba zpětně importovat. Jakmile práci dokončíme, stačí uložit pouze nultou vrstvu a naimportovat ji zpátky do \textbf{Composeru} pomocí tlačítka \textbf{Import} (viz obr \ref{fig:result}).

\newpage{}

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=1\textwidth]{img/result}
\end{center}
\caption{Výsledný dům po importu}
\label{fig:result}
\end{figure}

\section{New link}

Stránka \textit{New link} (viz obr. \ref{fig:link}) slouží jak jako zakládací, tak jako editační formulář pro vazbu mezi projektem a solutionem. Tento formulář obsahuje výklopník s povinnou volbou projektu, dále pak tři položky pro posuv po všech třech osách a na závěr úhel natočení. Všechny položky jsou povinné, pokud nejsou vyplněné, tak nelze uložit danou \textit{vazbu}. Editace je rozpoznána neprazdným parametrem při navigaci, konkrétně předáním instance \textit{vazby}, kterou chceme editovat. Po stisku tlačítka ,,Save'' dojde k přesměrování na \textit{detail solutionu} (viz obr. \ref{fig:solutiondetail}).


\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=0.85\textwidth]{img/link}
\end{center}
\caption{Připojení projektu k solutionu}
\label{fig:link}
\end{figure}

\begin{figure}[h!tb]
\begin{center}
\includegraphics[width=0.85\textwidth]{img/solutiondetail}
\end{center}
\caption{Ukázka Sídliště}
\label{fig:solutiondetail}
\end{figure}

\newpage{}

